home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.3 / WindowId.3 < prev   
Encoding:
Text File  |  1995-07-26  |  10.6 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      TTTTkkkk____WWWWiiiinnnnddddoooowwwwIIIIdddd((((3333))))               TTTTkkkk (((( ))))                TTTTkkkk____WWWWiiiinnnnddddoooowwwwIIIIdddd((((3333))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           Tk_WindowId,    Tk_Parent,    Tk_Display,    Tk_DisplayName,
  12.           Tk_ScreenNumber, Tk_Screen, Tk_X, Tk_Y, Tk_Width, Tk_Height,
  13.           Tk_Changes,   Tk_Attributes,   Tk_IsMapped,   Tk_IsTopLevel,
  14.           Tk_ReqWidth,      Tk_ReqHeight,      Tk_InternalBorderWidth,
  15.           Tk_Visual, Tk_Depth,  Tk_Colormap   -  retrieve  information
  16.           from Tk's local data structure
  17.  
  18.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  19.           ####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
  20.  
  21.           Window
  22.           TTTTkkkk____WWWWiiiinnnnddddoooowwwwIIIIdddd(_t_k_w_i_n)
  23.  
  24.           Tk_Window
  25.           TTTTkkkk____PPPPaaaarrrreeeennnntttt(_t_k_w_i_n)
  26.  
  27.           Display *
  28.           TTTTkkkk____DDDDiiiissssppppllllaaaayyyy(_t_k_w_i_n)
  29.  
  30.           char *
  31.           TTTTkkkk____DDDDiiiissssppppllllaaaayyyyNNNNaaaammmmeeee(_t_k_w_i_n)
  32.  
  33.           int
  34.           TTTTkkkk____SSSSccccrrrreeeeeeeennnnNNNNuuuummmmbbbbeeeerrrr(_t_k_w_i_n)
  35.  
  36.           Screen *
  37.           TTTTkkkk____SSSSccccrrrreeeeeeeennnn(_t_k_w_i_n)
  38.  
  39.           int
  40.           TTTTkkkk____XXXX(_t_k_w_i_n)
  41.  
  42.           int
  43.           TTTTkkkk____YYYY(_t_k_w_i_n)
  44.  
  45.           int
  46.           TTTTkkkk____WWWWiiiiddddtttthhhh(_t_k_w_i_n)
  47.  
  48.           int
  49.           TTTTkkkk____HHHHeeeeiiiigggghhhhtttt(_t_k_w_i_n)
  50.  
  51.           XWindowChanges *
  52.           TTTTkkkk____CCCChhhhaaaannnnggggeeeessss(_t_k_w_i_n)
  53.  
  54.           XSetWindowAttributes *
  55.           TTTTkkkk____AAAAttttttttrrrriiiibbbbuuuutttteeeessss(_t_k_w_i_n)
  56.  
  57.           int
  58.           TTTTkkkk____IIIIssssMMMMaaaappppppppeeeedddd(_t_k_w_i_n)
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      TTTTkkkk____WWWWiiiinnnnddddoooowwwwIIIIdddd((((3333))))               TTTTkkkk (((( ))))                TTTTkkkk____WWWWiiiinnnnddddoooowwwwIIIIdddd((((3333))))
  71.  
  72.  
  73.  
  74.           int                                                           |
  75.           TTTTkkkk____IIIIssssTTTTooooppppLLLLeeeevvvveeeellll(_t_k_w_i_n)                                          |
  76.  
  77.           int
  78.           TTTTkkkk____RRRReeeeqqqqWWWWiiiiddddtttthhhh(_t_k_w_i_n)
  79.  
  80.           int
  81.           TTTTkkkk____RRRReeeeqqqqHHHHeeeeiiiigggghhhhtttt(_t_k_w_i_n)
  82.  
  83.           int
  84.           TTTTkkkk____IIIInnnntttteeeerrrrnnnnaaaallllBBBBoooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh(_t_k_w_i_n)
  85.  
  86.           Visual *                                                      |
  87.           TTTTkkkk____VVVViiiissssuuuuaaaallll(_t_k_w_i_n)                                              |
  88.  
  89.           int                                                           |
  90.           TTTTkkkk____DDDDeeeepppptttthhhh(_t_k_w_i_n)                                               |
  91.  
  92.           Colormap                                                      |
  93.           TTTTkkkk____CCCCoooolllloooorrrrmmmmaaaapppp(_t_k_w_i_n)                                            |
  94.  
  95.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  96.           Tk_Window   _t_k_w_i_n   (in)      Token for window.
  97.      _________________________________________________________________
  98.  
  99.  
  100.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  101.           TTTTkkkk____WWWWiiiinnnnddddoooowwwwIIIIDDDD and the other names listed above are all  macros
  102.           that return fields from Tk's local data structure for _t_k_w_i_n.
  103.           None of these  macros  requires  any  interaction  with  the
  104.           server;  it is safe to assume that all are fast.
  105.  
  106.           TTTTkkkk____WWWWiiiinnnnddddoooowwwwIIIIdddd returns the X identifier for _t_k_w_i_n, or  NNNNUUUULLLLLLLL  if
  107.           no  X  window  has  been  created  for  _t_k_w_i_n  yet  (see the
  108.           TTTTkkkk____CCCCrrrreeeeaaaatttteeeeMMMMaaaaiiiinnnnWWWWiiiinnnnddddoooowwww manual entry for details).
  109.  
  110.           TTTTkkkk____PPPPaaaarrrreeeennnntttt returns Tk's  token  for  the  logical  parent  of
  111.           _t_k_w_i_n.   The  parent  is  the  token that was specified when
  112.           _t_k_w_i_n was created, or NULL for main windows.
  113.  
  114.           TTTTkkkk____DDDDiiiissssppppllllaaaayyyy returns a pointer to the Xlib  display  structure
  115.           corresponding  to  _t_k_w_i_n.   TTTTkkkk____DDDDiiiissssppppllllaaaayyyyNNNNaaaammmmeeee  returns an ASCII
  116.           string identifying _t_k_w_i_n's display.  TTTTkkkk____SSSSccccrrrreeeeeeeennnnNNNNuuuummmmbbbbeeeerrrr returns
  117.           the index of _t_k_w_i_n's screen among all the screens of _t_k_w_i_n's
  118.           display.  TTTTkkkk____SSSSccccrrrreeeeeeeennnn returns a pointer to the Xlib  structure
  119.           corresponding to _t_k_w_i_n's screen.
  120.  
  121.           TTTTkkkk____XXXX, TTTTkkkk____YYYY, TTTTkkkk____WWWWiiiiddddtttthhhh, and TTTTkkkk____HHHHeeeeiiiigggghhhhtttt return information about
  122.           _t_k_w_i_n'_s  location  within  its  parent  and  its  size.  The
  123.           location information refers to the upper-left pixel  in  the
  124.           window, or its border if there is one.  The width and height
  125.           information refers to the interior size of the  window,  not
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 7/23/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      TTTTkkkk____WWWWiiiinnnnddddoooowwwwIIIIdddd((((3333))))               TTTTkkkk (((( ))))                TTTTkkkk____WWWWiiiinnnnddddoooowwwwIIIIdddd((((3333))))
  137.  
  138.  
  139.  
  140.           including  any  border.   TTTTkkkk____CCCChhhhaaaannnnggggeeeessss  returns a pointer to a
  141.           structure containing all of the above information plus a few
  142.           other   fields.   TTTTkkkk____AAAAttttttttrrrriiiibbbbuuuutttteeeessss  returns  a  pointer  to  an
  143.           XSetWindowAttributes  structure  describing   all   of   the
  144.           attributes of the _t_k_w_i_n's window, such as background pixmap,
  145.           event  mask,  and  so  on  (Tk  keeps  track  of  all   this
  146.           information  as it is changed by the application).  Note: it
  147.           is  essential  that  applications  use  Tk  procedures  like
  148.           TTTTkkkk____RRRReeeessssiiiizzzzeeeeWWWWiiiinnnnddddoooowwww  instead of X procedures like XXXXRRRReeeessssiiiizzzzeeeeWWWWiiiinnnnddddoooowwww,
  149.           so that Tk can keep its data structures up-to-date.
  150.  
  151.           TTTTkkkk____IIIIssssMMMMaaaappppppppeeeedddd returns a non-zero value if _t_k_w_i_n is mapped  and
  152.           zero if _t_k_w_i_n isn't mapped.
  153.  
  154.           TTTTkkkk____IIIIssssTTTTooooppppLLLLeeeevvvveeeellll returns a non-zero value if _t_k_w_i_n  is  a  top-  |
  155.           level window (its X parent is the root window of the screen)  |
  156.           and zero if _t_k_w_i_n isn't a top-level window.
  157.  
  158.           TTTTkkkk____RRRReeeeqqqqWWWWiiiiddddtttthhhh and TTTTkkkk____RRRReeeeqqqqHHHHeeeeiiiigggghhhhtttt return  information  about  the
  159.           window's  requested  size.   These  values correspond to the
  160.           last call to TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt for _t_k_w_i_n.
  161.  
  162.           TTTTkkkk____IIIInnnntttteeeerrrrnnnnaaaallllBBBBoooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh returns the width of internal  border
  163.           that  has  been  requested  for  _t_k_w_i_n,  or 0 if no internal
  164.           border was requested.  The return value is simply  the  last
  165.           value passed to TTTTkkkk____SSSSeeeettttIIIInnnntttteeeerrrrnnnnaaaallllBBBBoooorrrrddddeeeerrrr for _t_k_w_i_n.
  166.  
  167.           TTTTkkkk____VVVViiiissssuuuuaaaallll,  TTTTkkkk____DDDDeeeepppptttthhhh,  and  TTTTkkkk____CCCCoooolllloooorrrrmmmmaaaapppp  return  information  |
  168.           about  the  visual  characteristics  of a window.  TTTTkkkk____VVVViiiissssuuuuaaaallll  |
  169.           returns the visual type for the window, TTTTkkkk____DDDDeeeepppptttthhhh returns the  |
  170.           number  of  bits  per  pixel,  and  TTTTkkkk____CCCCoooolllloooorrrrmmmmaaaapppp  returns the  |
  171.           current colormap for the window.  The visual characteristics  |
  172.           are  normally set from the defaults for the window's screen,  |
  173.           but they may be overridden by calling TTTTkkkk____SSSSeeeettttWWWWiiiinnnnddddoooowwwwVVVViiiissssuuuuaaaallll.
  174.  
  175.  
  176.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  177.           attributes,  colormap,  depth,  display,  height,   geometry
  178.           manager,  identifier,  mapped,  requested size, screen, top-
  179.           level, visual, width, window, x, y
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 7/23/95)
  196.  
  197.  
  198.  
  199.